Hide Table of Contents
PDM Pro API Web Service
Postapi/{vaultName}/searchvariables
PDM Pro API Web Service > Search Resource Group : api/{vaultName}/searchvariables (Post)
Description
Specifies parameters and variables for a search.
Parameters
NameDescriptionData Type

 

(Required URI parameter) Name of vault

string

(Body and Response parameter) File name or folder name or empty; supports "%" wildcard search

(Member of SearchVariables Model) (See Remarks)

string

(Body parameter)

Files = 1,

Folders = 2, or

Files and folders = 3

(Member of SearchVariables Model)

SearchObjectTypeCriteria

(Body parameter)

Relative folder path where the search begins; if empty, search starts at vault root

(Member of SearchVariables Model)

string

(Body parameter)

Current folder = 1,

Current folder and subfolders = 2,

All folders = 3

(Member of SearchVariables Model)

SearchPathCriteria

(Body parameter)

Search in latest version of files = 1

Search in all versions of files = 2

(Member of SearchVariables Model)

SearchVersionCriteria

(Body parameter)

None = 0

AND = 1

OR = 2

(Member of SearchVariables Model)

SearchOperand

(Body parameter)

List of variables to search for; can be empty

(Member of SearchVariables Model) (See Remarks)

Collection of SearchVariable

(Response) File ID

(Member of ObjectInfo Model)

integer

(Response) File size

(Member of ObjectInfo Model)

 

integer

(Response) Modification date

(Member of ObjectInfo Model)

 

date

(Response) File version

(Member of ObjectInfo Model)

 

integer

(Response) Workflow state

(Member of ObjectInfo Model)

string

(Response) Workflow state ID

(Member of ObjectInfo Model)

integer

(Response) Parent folder ID

(Member of ObjectInfo Model)

integer

(Response) Folder path

(Member of ObjectInfo Model)

string

(Response)

Folder = 0

File = 1

Bom = 3

(Member of ObjectInfo Model)

ObjectType

(Response) Whether the file is checked out

(Member of ObjectInfo Model)

integer

(Response) ID of user who checked out the file

(Member of ObjectInfo Model)

integer

(Response) Whether the file is shared

(Member of ObjectInfo Model)

integer

(Response) Whether the file is a toolbox item

(Member of ObjectInfo Model)

integer

(Response) Whether the file is deleted

(Member of ObjectInfo Model)

integer
Request (application/json, text/json)

Sample Data

{
  "Name": "sample string 1",
  "ObjectTypeCriteria": 1,
  "StartPath": "sample string 2",
  "PathCriteria": 1,
  "VersionCriteria": 1,
  "SearchOperand": 0,
  "Variables": [
    {
      "VariableName": "sample string 1",
      "SearchValue": "sample string 2"
    },
    {
      "VariableName": "sample string 1",
      "SearchValue": "sample string 2"
    }
  ]
}
Request (application/xml, text/xml)

Sample Data

<SearchVariablesModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SWPDM.Models">
  <Name>sample string 1</Name>
  <ObjectTypeCriteria>File</ObjectTypeCriteria>
  <PathCriteria>CurrentFolder</PathCriteria>
  <SearchOperand>NONE</SearchOperand>
  <StartPath>sample string 2</StartPath>
  <Variables>
    <SearchVariable>
      <SearchValue>sample string 2</SearchValue>
      <VariableName>sample string 1</VariableName>
    </SearchVariable>
    <SearchVariable>
      <SearchValue>sample string 2</SearchValue>
      <VariableName>sample string 1</VariableName>
    </SearchVariable>
  </Variables>
  <VersionCriteria>LatestVersion</VersionCriteria>
</SearchVariablesModel>
Request (application/x-www-form-urlencoded)

Response (application/json, text/json)

Sample Data

[
  {
    "Id": 1,
    "Name": "sample string 2",
    "Size": 3,
    "ModifiedDate": "2024-02-26T09:20:51.4876649-05:00",
    "Version": 5,
    "State": "sample string 6",
    "StateId": 7,
    "ParentFolderId": 8,
    "Path": "sample string 9",
    "Type": 0,
    "IsLocked": 10,
    "LockedBy": 11,
    "IsShared": 12,
    "IsToolbox": 13,
    "IsDeleted": 14
  },
  {
    "Id": 1,
    "Name": "sample string 2",
    "Size": 3,
    "ModifiedDate": "2024-02-26T09:20:51.4876649-05:00",
    "Version": 5,
    "State": "sample string 6",
    "StateId": 7,
    "ParentFolderId": 8,
    "Path": "sample string 9",
    "Type": 0,
    "IsLocked": 10,
    "LockedBy": 11,
    "IsShared": 12,
    "IsToolbox": 13,
    "IsDeleted": 14
  }
]
Response (application/xml, text/xml)

Sample Data

<ArrayOfObjectInfo xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SWPDM.Models">
  <ObjectInfo>
    <Id>1</Id>
    <IsDeleted>14</IsDeleted>
    <IsLocked>10</IsLocked>
    <IsShared>12</IsShared>
    <IsToolbox>13</IsToolbox>
    <LockedBy>11</LockedBy>
    <ModifiedDate>2024-02-26T09:20:51.4876649-05:00</ModifiedDate>
    <Name>sample string 2</Name>
    <ParentFolderId>8</ParentFolderId>
    <Path>sample string 9</Path>
    <Size>3</Size>
    <State>sample string 6</State>
    <StateId>7</StateId>
    <Type>Folder</Type>
    <Version>5</Version>
  </ObjectInfo>
  <ObjectInfo>
    <Id>1</Id>
    <IsDeleted>14</IsDeleted>
    <IsLocked>10</IsLocked>
    <IsShared>12</IsShared>
    <IsToolbox>13</IsToolbox>
    <LockedBy>11</LockedBy>
    <ModifiedDate>2024-02-26T09:20:51.4876649-05:00</ModifiedDate>
    <Name>sample string 2</Name>
    <ParentFolderId>8</ParentFolderId>
    <Path>sample string 9</Path>
    <Size>3</Size>
    <State>sample string 6</State>
    <StateId>7</StateId>
    <Type>Folder</Type>
    <Version>5</Version>
  </ObjectInfo>
</ArrayOfObjectInfo>
Example
Remarks

If Name and Variables are provided, search returns all items matching variables and name (+ other criteria).

 

If Name is empty and Variables are provided, search returns all items matching the variables (+ other criteria).

 

If Variables are empty and only Name is provided, search returns all items matching the name (+ other criteria).

 

If Name and Variables are empty, search returns all items based on other criteria.

See Also


Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   api/{vaultName}/searchvariables (Post)
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:

x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: API Help (English only) 2024 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.